home *** CD-ROM | disk | FTP | other *** search
/ Amiga Game-Power / Amiga Game-Power.iso / anwendungen / d mouse / memopad / memopad.doc < prev    next >
Text File  |  1994-05-20  |  18KB  |  370 lines
  1.   MemoPad and CheckMemo are products which may be freely distributed 
  2.   on the condition that they are not altered in any way, either by 
  3.   omission or addition to the contents of the ARC file.
  4.  
  5.   The author welcomes comments, suggestions for improvement, and any 
  6.   praise you may have for this product.  He may be reached at the 
  7.   following address:
  8.  
  9.                         Michael Griebling    
  10.                       COMPUTER INSPIRATIONS
  11.                     150 Clark Blvd., Suite One
  12.                    Brampton, ON, Canada, L6T 4Y8
  13.                          (416) 792-6797
  14.  
  15.   In order to reward anyone wishing to be registered for a nominal fee 
  16.   of $20, for a limited time, a free upgrade will be given to the 
  17.   commercial release of MemoPad.  Suggested list price of the 
  18.   enhanced program is $45.  The commercial release is expected near the
  19.   end of 1988.  FREE upgrades to the commercial version will be made
  20.   available to any users who have registered before this release date.
  21.  
  22.  
  23.                     Commercial Release Version
  24.                     ==========================
  25.  
  26.   In order to better support users of MemoPad we will be producing a
  27.   commercial version which may be known under a different name -- yet
  28.   to be determined.  Our working name has been MemoPad V2.0.  Due to
  29.   a significant number of changes we may be forced to change the name
  30.   to better describe this new product.  Following is a partial list of
  31.   planned features :
  32.  
  33.     1) An address book facility with an automatic telephone dialer 
  34.        will be added.
  35.  
  36.     2) A daily appointment utility will be supported which allows
  37.        appointments to be booked at selectable intervals.
  38.    
  39.     3) The original MemoPad functions will also be available along
  40.        with a facility to allow batch processing to be invoked via
  41.        a dated and timed memo item.
  42.  
  43.     4) A speech facility will be added to allow memo items or 
  44.        appointments to be announced.
  45.  
  46.     5) More options will be added to give more flexibility in
  47.        selecting screen colours, methods of repeating memos and
  48.        appointments, and in reporting matured items.
  49.  
  50.     6) Text import/export into/from the address book, appointments,
  51.        or memo items will be supported.
  52.  
  53.   Note that although all these additions are planned to appear in the
  54.   commercial release we cannot guarantee that they will operate exactly
  55.   as described above.  Whenever possible we will attempt to improve on
  56.   our offerings and thus the list above may become obsolete.  Please
  57.   contact us at the above address or telephone number to get up to date
  58.   information.   
  59.   
  60.  
  61.                    Installing MemoPad & CheckMemo
  62.                    ==============================
  63.  
  64.   There should be a total of 7 files for this program set.  As soon as
  65.   you invoked `ClickMe', all the names (if they were de-arced) were
  66.   auto-magically expanded out, so you won't have to go through the
  67.   usual hassle of EXECUTING the Execute.Me file that is usual in these
  68.   cases. 
  69.  
  70.   Install MemoPad as follows from the Command Line Interpreter (CLI) :
  71.   (Make certain there is enough disk space to hold the copied files.
  72.    The MemoPad disk icon should be named `MemoPad:'.  Substitute the
  73.    name/directory of the disk which is to hold the MemoPad utility
  74.    in place of the dummy "Working Disk" name).
  75.  
  76.   FROM CLI :
  77.       Copy MemoPad:CheckMemo to C:
  78.       Copy MemoPad:MemoPad#? to "Working Disk"
  79.       Copy MemoPad:CheckMemo#? to "Working Disk"
  80.       Copy MemoPad:ClickMe#? to "Working Disk"
  81.       Copy S:Startup-Sequence to S:Startup-Old
  82.  
  83.   Finally, in order to automatically invoke `CheckMemo' when the
  84.   AMIGA is powered on, invoke your favourite editor to modify the
  85.   following file : S:Startup-Sequence.  Place the line `CheckMemo',
  86.   without the quotes, near the end of this file, just before the
  87.   line containing `EndCLI > Nil:'.
  88.  
  89.   Note: you can also manually check the memo items at any time simply
  90.   by typing `CheckMemo' from CLI or by clicking on the CheckMemo icon.
  91.   If nothing happens except a disk access when you invoke CheckMemo,
  92.   don't worry -- it just means that no memo items were found for
  93.   today's date.
  94.  
  95.   The MemoPad utility, which creates the memo items read by CheckMemo,
  96.   was placed on your working disk as part of the installation.  It is
  97.   also possible to just drag the MemoPad icon over to your working
  98.   disk.
  99.  
  100.                           MemoPad Operation
  101.                           =================
  102.  
  103.   MemoPad is a WorkBench utility which runs in a separate window on
  104.   the WorkBench screen. It is capable of allowing you to generate memo
  105.   items which are simply dated reminders of appointments, birthdays,
  106.   holidays, or any to do list.  Each memo item can be any length, 
  107.   limited only by the amount of memory or disk space where the memos
  108.   are stored.
  109.  
  110.   When MemoPad is first invoked, it searches the S: startup directory 
  111.   for a file called MEMOPAD.DAT.  This file contains all the memo items
  112.   which have been entered by yourself.  Naturally, the first time it is
  113.   invoked, MemoPad won't find this file and will attempt to create one.
  114.   At this time, you may get a message indicating that the WorkBench
  115.   disk is required or that you should unprotect the write tab.  
  116.  
  117.   During start-up, one other file is accessed : MEMOPAD.CUS.  This file
  118.   contains user customization information which allows you to customize
  119.   the MemoPad operation to your individual preferences via the 
  120.   CUSTOMIZE menu selection in MemoPad.  If this file is not found, 
  121.   MemoPad makes some assumptions and gives you a 24-hour clock, a 
  122.   day-month-year date, and a plain MemoPad title.  Naturally, you can 
  123.   customize all these parameters and the next time MemoPad is invoked,
  124.   all your selections will be used.  By the way, the same selections 
  125.   will also be used by CheckMemo.
  126.  
  127.  
  128.                   Changing the Data File Directory
  129.                   ================================
  130.  
  131.   We felt that everyone would have WorkBench in their drive during 
  132.   startup, so this is where MemoPad normally assumes it will find your
  133.   memo items.  If you don't like these files on your WorkBench disk, 
  134.   then it is possible to change the directory where MemoPad will look.
  135.   device to some other disk.  MemoPad and CheckMemo both accept an
  136.   optional parameter on the command line which is the directory which
  137.   they will use in place of the default S: directory.  To change from
  138.   the default simply edit the S:Startup-Sequence file again, replacing
  139.   the `CheckMemo' line with `CheckMemo DIRECTORY', where DIRECTORY is
  140.   replaced by a directory or device string.  As an example, if we wish
  141.   the MemoPad files to be placed on our working disk, WORK:, and in 
  142.   the MemoFiles directory, we would enter `CheckMemo WORK:MemoFiles'
  143.   into the S:Startup-Sequence file.  Whenever invoking MemoPad, you
  144.   will also have to remember to specify the new directory in the
  145.   CLI invocation line, so for our example, we would type :
  146.   `MemoPad WORK:MemoFiles'.
  147.  
  148.   If invoking MemoPad and/or CheckMemo from the WorkBench, simply edit
  149.   the INFO file from the corresponding WorkBench menu, after having
  150.   selected either the MemoPad or the CheckMemo icon, and place the 
  151.   desired new directory specification as the first item in the 
  152.   `Tool Types' string gadget.  Thus our example from above would
  153.   require that the default tool type entry of `MEMODIR=S:' be 
  154.   changed to read the following instead : `MEMODIR=WORK:MemoFiles'.
  155.   Don't include the quotes.  Be sure to do this for both the MemoPad
  156.   and CheckMemo icons.
  157.  
  158.  
  159.                         Operating Instructions
  160.                         ======================
  161.  
  162.   Creating a Memo Item
  163.   --------------------
  164.   Click on the ENTER button to create a memo item.  The total number
  165.   of memos should increase by one and the newly created item will be
  166.   automatically assigned today's date.  The comment field will be
  167.   blank.  To enter some text, just point to the line where the text
  168.   is to be placed and click with the left mouse button.  Then type
  169.   the memo text.  A RETURN will automatically take you to the next
  170.   line of the comments.  
  171.  
  172.   Comments longer than five lines can be created by clicking on the
  173.   down arrow under the comment scroll bar.  The scroll bar will reduce
  174.   to half its original size.  The text which is displayed represents
  175.   those five memo lines located in the scroll bar range.  Thus, if
  176.   we created a new page of comments, we now have a total of ten 
  177.   comment lines available for this memo item.  The scroll bar's
  178.   position illustrates where we are within this ten line range.  By
  179.   clicking on the down arrow repeatedly, additional comment pages in
  180.   multiples of five lines are created.  New pages are created as soon
  181.   as the scroll bar reaches the bottom of its container and the down
  182.   arrow is clicked.  The only limitation to the comment size is the 
  183.   amount of memory available.  A help message will let you know when
  184.   you run out of memory.
  185.  
  186.   The up and down arrows work in cooperation with the scroll bar to
  187.   advance the comment window up or down by a single line of text.
  188.   Click on the up arrow to move up a line and click on the down arrow
  189.   to move down a line.  Pages of five lines are traversed by clicking
  190.   just within the scrolling container either under the scroll bar to
  191.   move down five lines or above the scroll bar to move up by five
  192.   lines.
  193.  
  194.   A trailing blank page of comment lines is automatically deleted once
  195.   it is no longer visible.  The scroll bar also changes its size 
  196.   and position to reflect the reduced number of comment lines. 
  197.   Blank page deletion occurs either when the scroll bar is dragged to
  198.   the top of the scroll container or repeated clicks on the up arrow
  199.   cause the blank page to scroll off the comment area.
  200.  
  201.  
  202.   Viewing Memo Items
  203.   ------------------
  204.   The date window, which normally is used to set a memo item's date,
  205.   can also be used to display all the memo items for a given month.
  206.   Just click on the VIEW button and all memo items for the current
  207.   month will be highlighted in the date window.  Any dates with more
  208.   than one item will be outlined.  To see the contents of one of 
  209.   these memo items, just click on the highlighted date.  The related
  210.   memo item will be displayed in the main window. (You may have to
  211.   move or QUIT the date window in order to see the full memo text.)  
  212.   Multiple memos on a single date are displayed in a similar manner.
  213.   Once the first memo item has been shown, the MORE button in the
  214.   date window will light up to indicate that additional items are
  215.   available.  Click on the MORE button to see these memos one at a
  216.   time.
  217.  
  218.  
  219.   Printing Memo Items
  220.   -------------------
  221.   The Print menu options give printer output from all the memo items or
  222.   just the memo currently being displayed.  By displaying only selected
  223.   items, then invoking the single memo print option from the menu, it
  224.   is possible to selectively print only those memos due for a single
  225.   day.  The amount of space on the left of the printed memo items can
  226.   be altered by adjusting the printer left margin from within
  227.   Preferences.  Make certain that the right margin is adjusted so that
  228.   sufficient space is available on the print line to contain a full 
  229.   line of comment text.
  230.  
  231.  
  232.   Repeating Memo Items
  233.   --------------------
  234.   MemoPad lets you specify repeated memo items which occur fairly 
  235.   regularly on a daily, weekly, monthly, or annual basis for a fixed
  236.   length of time.  To generate such a memo item, first you'll have to
  237.   enable repeats by selecting one of the repeat choices in the REPEAT
  238.   MEMO menu list. By default, repeats will be disabled as is shown by
  239.   the checkmark in front of the "No Repeat" menu item.  Choose one of
  240.   the repeat options and use the NEXT or PREV buttons to get to the
  241.   memo you wish to have repeated.  Click on the DATE button, and use
  242.   the Date Window controls to get to the starting date to be repeated.
  243.   Click on the desired date.  All repeated dates will now also be
  244.   selected.  Use the Date Window controls to check them if you don't
  245.   believe it could be that easy.  Click on the OK button to close the
  246.   Date Window and accept the chosen date; otherwise, just click on
  247.   the QUIT button to keep whatever date was originally on your memo
  248.   item.
  249.  
  250.   
  251.   Finding a Dated Item
  252.   --------------------
  253.   The FIND button and the related menu item will let you find one memo
  254.   out of the list of memo items which you have defined.  Click on this
  255.   button, use the Date Window controls to maneuver to the desired date,
  256.   and click on the date to be found.  Click on the OK button and the
  257.   first memo item with this date will be located and displayed.  This
  258.   date search may be cancelled by clicking on the QUIT button.  If the
  259.   date is not found, a message indicating this will be displayed in the
  260.   Help Window.  A trick, which may be used to find any memo item in
  261.   a given month might be to select the daily repeat for a month before
  262.   clicking on the Date button.  Any date which is selected will now
  263.   cause a search throughout the entire repeat range for any matching
  264.   memo item dates.
  265.  
  266.  
  267.   Help Window
  268.   -----------
  269.   The Help Window is a context sensitive help feature which displays
  270.   help messages as various buttons and/or menu selections are made.
  271.   It is located in the top rightmost portion of the MemoPad window.
  272.  
  273.  
  274.   Automatic Memo Item Backup
  275.   --------------------------
  276.   There is never any need to worry whether or not all your memo items
  277.   have been saved to disk!  MemoPad will automatically update the disk
  278.   file, as soon as it notices that some memo item has been changed.
  279.   Even if some other program should cause the AMIGA to crash in a 
  280.   shower of fireworks, you'll be secure in the knowledge that your
  281.   memo items are safe.
  282.  
  283.  
  284.                         About the Modula-2 Source
  285.                         =========================
  286.  
  287.   We, as a company, provide the source code for MemoPad and CheckMemo
  288.   primarily to give interested individuals the tools for programming
  289.   the Amiga using the Intuition-based interface in Modula-2.  Included
  290.   in the source are many examples of gadget-based control, menu 
  291.   initialization and use, window creation and manipulation, and 
  292.   requester window use. Although bits and pieces of what we do are 
  293.   available in other programs, we feel that having an example which
  294.   unites all the working principles required to produce a full program
  295.   is beneficial to novice AMIGA programmers.  Our primary aim, of 
  296.   course, was to produce a program from which others could see how to
  297.   work within an Intuition-based environment using Modula-2; and in 
  298.   this respect, we feel that we have succeeded.
  299.   
  300.   
  301.                             Acknowledgements
  302.                             ================
  303.  
  304.   As always, there are a bunch of people behind the scenes who must be
  305.   thanked for their contributions, either direct or indirect, to a 
  306.   program such as this.  Firstly, thanks to TDI for their Modula-2
  307.   compiler, which may not be fastest or the best, but it certainly was
  308.   the first.  Secondly, thanks to all the people who have contributed
  309.   public-domain programs to demonstrate Modula-2 concepts and give 
  310.   others source code examples upon which to build.  In particular,
  311.   thanks to Richie Bielak for his FastTextIO routines, used in this
  312.   previewer and thanks also go to Jerry Mack for his TextTools module
  313.   used in MemoPad. We also appreciate the artistic talents of Anna Lise
  314.   Scheel, Colour Consultant, for her work on MemoPad.  Thanks also to
  315.   all the Beta test sites (you know who you are) for their assistance
  316.   and helpful comments.  Thanks also to the people who brought us
  317.   PowerWindows which was used as a starting point for the design of
  318.   windows, gadgets, menus, and requesters used in both MemoPad and
  319.   CheckMemo.  Although, the Modula-2 extensions to this program are
  320.   VERY buggy and have been given inadequate thought, the tool has been
  321.   useful. Finally, thanks to the makers of the Amiga -- without whom
  322.   none of this would have been possible.
  323.  
  324.  
  325.                                Bug Fixes
  326.                                =========
  327.  
  328.   Much as we hate to admit it, a few bugs crept into the V1.0 release
  329.   of MemoPad and CheckMemo.  Thanks to the people who pointed out the
  330.   bugs (people tend to do that).  All known bugs as listed below have
  331.   been exterminated :
  332.  
  333.      Bug 1.0-1  The programs stomped over memory location 00000000
  334.                 while starting up and initializing the Date window.
  335.                 Although this bug didn't usually cause the programs
  336.                 to crash, sometimes, if another program depended on
  337.                 something in memory location 00000000, a crash could
  338.                 occur.  As a matter of fact, if both MemoPad and
  339.                 CheckMemo were running together (yes, they can do
  340.                 that too), closing down one would cause the other
  341.                 one to crash the Amiga.  In our defense, the bug
  342.                 was traced to a pointer to a pointer which the
  343.                 current V3.0a TDI Modula-2 compiler doesn't seem to
  344.                 handle very well.  PowerWindows forced us to use
  345.                 the awkward pointer to a pointer syntax (they must
  346.                 be `C' programmers!), hence our memory stomping.
  347.  
  348.      Bug 1.0-2  To our shock, we discovered that the DOS date was 
  349.                 in error by one day (at least during this leap year).
  350.                 It worked fine last year. ;-)
  351.                 A new algorithm is now being used.
  352.  
  353.   To date no bugs have been reported for MemoPad V1.1.  Please let
  354.   us know if you find any in this V1.2 release.
  355.    
  356.                 
  357.                         About Computer Inspirations
  358.                         ===========================
  359.  
  360.   Although COMPUTER INSPIRATIONS is fairly new to the AMIGA and other 
  361.   personal computers, we have gained considerable experience in 
  362.   software and hardware development from work in the aerospace industry
  363.   and from a university environment.  We are committed to bringing 
  364.   quality products to AMIGA owners at affordable prices.  We will make
  365.   certain that all our products reflect this attention to detail and
  366.   we will respond promptly to any customer problems or concerns.
  367.  
  368.   Michael Griebling,
  369.   President, COMPUTER INSPIRATIONS
  370.